*Changes:*

- **Improvement:** ❇️ Adjust the MD to lower the sensitivity, thus improving the global detection reliability (69 76) 
- **Improvement:** ❇️ Allow fallback on specified encoding if any (71)
- **Bugfix:** 🐛 The CLI no longer raise an unexpected exception when no encoding has been found (70)
- **Bugfix:** 🐛 Fix accessing the 'alphabets' property when the payload contains surrogate characters (68)
- **Bugfix:** 🐛 ✏️ The logger could mislead (explain=True) on detected languages and the impact of one MBCS match (in 72) 
- **Bugfix:** 🐛 Submatch factoring could be wrong in rare edge cases (in 72)
- **Bugfix:** 🐛 Multiple files given to the CLI were ignored when publishing results to STDOUT. (After the first path) (in 72)
- **Internal:** 🎨  Fix line endings from CRLF to LF for certain files (67)

- Improved text of skipped file message to mention gitignore feature.
- Made all exceptions pickleable.
- Fixed 1779: Pylama integration ignores pylama specific isort config overrides.
- Fixed 1781: `--from-first` CLI flag shouldn't take any arguments.
- Fixed 1792: Sorting literals sometimes ignored when placed on first few lines of file.
- Fixed 1777: extend_skip is not honored wit a git submodule when skip_gitignore=true.

------------------
- Unix: Fallback to default if XDG environment variable is empty

===========================
Release date: 2021-07-28

* Fix a false positive ``undefined-variable`` when variable name in decoration
matches function argument

Closes 3791

- Deprecated
- Text file objects as input to `load`.
 Binary file objects should be used instead to avoid opening a TOML file with universal newlines or with an encoding other than UTF-8.

--------------------

Bugfixes
^^^^^^^^

- ``get_requires_for_build_sdist`` hook (PEP 517) is assumed to return an empty list if left unimplemented by the backend build system - by :user:`oczkoisse`
`2130 <https://github.com/tox-dev/tox/issues/2130>`_


Documentation
^^^^^^^^^^^^^

- The documentation of ``install_command`` now also mentions that you can provide arbitrary commands - by :user:`jugmac00`
`2081 <https://github.com/tox-dev/tox/issues/2081>`_

- `asyncio.gather` API consistency with stdlib (1212)
- fix shutdown exception (1209 <- 1198)
- misc build framework updates (1209)
- add [GH Sponsors](https://github.com/sponsors/tqdm/dashboard/tiers?frequency=one-time) & [merch](https://tqdm.github.io/merch) links

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Removed ``xonsh`` activator due to this breaking fairly often the CI and lack of support from those packages
maintainers, upstream is encouraged to continue supporting the project as a
`plugin <https://github.com/xonsh/xonsh/issues/3689>`_  - by :user:`gaborbernat`. (`#2160 <https://github.com/pypa/virtualenv/issues/2160>`_)